Target Panel

Description

The Panel to navigate to when the user logs in successfully.

Discussion

If the After login behavior property is set to "FocusPanelCard", the Target Panel property is shown. This property defines the Panel in the UX component to navigate to after the user logs in to the application. In the Login UX, this property is set to PANELCARD_APPLICATION.

The "FocusPanelCard" option is often used in mobile apps that need to work offline. The alternative, "RedirectToTargetPage", makes a call to the Application Server to load the specified target page. If your device is offline, the page cannot be loaded.

To use the "FocusPanelCard" method, place your main application inside the specified Target Panel on the UX. When the user logs in, the panel containing the app is shown. The main application can be included as an embedded component or by directly adding the controls for your app to the panel.

You can override the default Target Panel at runtime using the AfterLogin client-side event. This is done using the {dialog.object}.panelSetActive() method to navigate to the desired Panel. For example, the code below checks to see if the Address control is blank. If the control is blank, the user is shown PANELCARD_DATACAPTURE where the user is then asked to enter their Address.

var address = {dialog.object}.getValue("ADDRESS");

if (address == "") {
    {dialog.object}.panelSetActive('PANELCARD_DATACAPTURE');
}

The code above only calls the panelSetActive() method when there is no address. In the event that the address is not blank, the application navigates to the default Panel set in the Target Panel property.